home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Standards 1994 January / InfoMagic Standards - January 1994.iso / iso / 9660 / rockrdge / rrg.09 / api.nr next >
Text File  |  1992-08-19  |  4KB  |  112 lines
  1. .sp
  2. .H 1 "REQUIREMENTS FOR SYSTEMS"
  3. .sp
  4. The System Use Sharing Protocol specifies that certain information 
  5. shall be communicated between a user and an implementation.
  6. .sp
  7. An information processing system that conforms to this protocol shall
  8. be the subject of a description which identifies the means by which 
  9. the user may supply such information, or may obtain it when it is 
  10. made available, as specified in this standard.
  11. .sp
  12. .H 2 "Requirements for an Originating System"
  13. .sp
  14. All originating systems which claim to implement the System Use Sharing
  15. Protocol must comply with the protocol throughout each recorded System
  16. Use Area.
  17. .sp
  18. The implementation shall be capable of recording a set of System
  19. Use Fields in System Use Areas that are specified in this standard,
  20. on a Volume Set in accordance with one of the interchange levels
  21. specified in ISO 9660:1988.
  22. .sp
  23. The implementation shall allow the data preparer to supply the information
  24. that is to be recorded in the System Use Area according to the 
  25. System Use Sharing Protocol and shall supply the information for a field
  26. if the data preparer does not supply it.
  27. .sp
  28. .H 2 "Requirements for a Receiving System"
  29. .sp
  30. All receiving systems which claim to implement the System Use Sharing
  31. Protocol must implement the "CE" System Use Field as defined in this
  32. specification.
  33. .sp
  34. Any System Use Field which the receiving system does not recognize is
  35. to be ignored and skipped.
  36. .sp
  37. The implementation shall be capable of reading a set of System
  38. Use Fields in System Use Areas that are specified in this standard
  39. from a Volume Set in accordance with one of the interchange levels
  40. specified in ISO 9660:1988.
  41. .sp
  42. The implementation shall allow the user to supply information sufficient
  43. to enable the implementation to locate the System Use Fields in System
  44. Use Areas required by the user, and to locate the volumes on which 
  45. these are recorded.
  46. .sp
  47. The implementation shall make available to the user the information
  48. that is recorded in each of the System Use Fields in each System 
  49. Use Area.
  50. .sp
  51. .H 2 "Requirements for an Application Programming Interface"
  52. .sp
  53. All receiving systems which claim to implement the System
  54. Use Sharing Protocol must implement an Application Programming
  55. Interface (API) to provide access to the information recorded in
  56. the System Use Areas within a volume.
  57. .sp
  58. .bp
  59. .sp
  60. .sp
  61. The API must provide a mechanism to verify the use of the
  62. SUSP (by checking for the existence of a valid "SP" field) and
  63. retrieve data recorded in the System Use Areas within a volume.
  64. The mechanism must, at a minimum, be able to retrieve, for each
  65. Directory Record:
  66. .sp
  67. .sp
  68. .BL
  69. .LI
  70. a complete, individual System Use Field, including all
  71. header information, selectable by Signature, field count
  72. or both; and,
  73. .LI
  74. the contents of the Skip Area, BP 1 to LEN_SKP of the
  75. System Use Area of the Directory Record.
  76. .LE
  77. .sp
  78. .sp
  79. Optionally, the API may also provide a mechanism to
  80. retrieve, for each Directory Record:
  81. .sp
  82. .sp
  83. .BL
  84. .LI
  85. a concatenated collection of all fields with a specific
  86. Signature in recorded order; or,
  87. .LI
  88. a concatenated collection of all fields in recorded order.
  89. .LE
  90. .sp
  91. .sp
  92. The mechanism to retrieve such data must be able to
  93. correctly and transparently interpret pertinent "CE" System Use
  94. Fields to assure the complete retrieval of the requested data.
  95. .sp
  96. .H 2 "Coexistence with other Extensions and SUSP Registry"
  97. .sp
  98. Adherence to the System Use Sharing Protocol provides for the
  99. mutual coexistence of different system-specific extensions
  100. to ISO 9660:1988 by defining System Use Fields to be recorded
  101. in System Use Areas.
  102. .sp
  103. A registry system will be established to
  104. monitor and record existing and new System Use Field specifications and
  105. distribute this information to individuals or organizations pursuing
  106. the implementation of new and/or compatible system-specific extensions.
  107. .sp
  108. .H 2 "Implementation Suggestions"
  109. .sp
  110. For special cases, receiving systems are encouraged to provide a mechanism
  111. to optionally disable the System Use Sharing Protocol in its entirety.
  112.